home *** CD-ROM | disk | FTP | other *** search
/ Artville: Business Characters / Artville - Business Characters.iso / pc / win_kudo / install / suport16.lib / KUDOINI.TXT < prev    next >
Text File  |  1995-05-19  |  8KB  |  170 lines
  1.  
  2.                Kudo½ Image Publisher(tm) for Windows TechNote
  3.                    (c) 1993 Imspace Systems Corporation.
  4.                             All Rights Reserved.
  5.  
  6.  
  7. This file documents the structure and syntax of the KUDO.INI file.
  8. The KUDO.INI file follows the standard Windows syntax for all .INI files.
  9.  
  10.  
  11. ******************************************************************************
  12. These are the sections in KUDO.INI and their function:
  13.  
  14. [KudoImageBrowserImports]       Associates a file extension with a filter DLL
  15. [KudoPlacePacks]                Associates an application with a place module
  16. [OLEDropTargets]                Identifies a registered OLE 2.0 drop target
  17.  
  18. Each of these sections can have zero or more entries following the section 
  19. header.
  20.  
  21. ******************************************************************************
  22. [KudoImageBrowserImports]
  23. -------------------------
  24. The entries in this section list all of the file types that Kudo Image Browser 
  25. can recognize and catalog.  This feature is provided to enable users to add 
  26. more import filters & file types, and redefine what file extensions Kudo uses 
  27. to recognize each file type.
  28.  
  29. To read image and multimedia files of different formats, Kudo uses a modular 
  30. system based on the industry standard Aldus filter specification.  This system 
  31. allocates a specific external Dynamic Link Library file (a .DLL file) for each 
  32. file type to be recognized.  These DLL's are known as import filters, or 
  33. filters.
  34.  
  35. Kudo uses a file's extension to identify what type of file it is, and 
  36. consequently, which filter DLL to load in order to read that file.  The 
  37. [KudoImageBrowserImports] section  of KUDO.INI tells Kudo 1) what file 
  38. extension represents a particular file format, and 2) which filter to load in 
  39. order to read that file.
  40.  
  41. The syntax of one of these entries is:
  42.  
  43.         <description>=<path>,<extension>
  44.  
  45. where
  46.         <description>:  Cosmetic text that describes the particular file type
  47.         <path>:         Path (full or relative) to the .FLT or .DLL file
  48.                         that functions as the import filter for this file
  49.                         type.  This is a regular DOS pathname.  If it is not a
  50.                         fully qualified path, it is interpreted as relative to
  51.                         the directory where the currently executing copy of
  52.                         KUDO.EXE was found.
  53.         <extension>:    1-4 character text specifying the file extension to
  54.                         associate with this file type.  The dot '.' is
  55.                         optional.
  56.  
  57. There should be no spaces around the equal sign ('=') or comma (','). For 
  58. example, the following entry:
  59.  
  60.         [KudoImageBrowserImports]
  61.         ZSoft PC Paintbrush Bitmap=filters\IRPCX9.FLT,PCX
  62.  
  63. would be interpreted as follows:
  64.  
  65.         <description>: "ZSoft PC Paintbrush Bitmap"
  66.         <path>: "filters\IRPCX9.FLT"
  67.         <extension>: "PCX"
  68.  
  69. This entry tells Kudo that 1) files with a .PCX extension are "ZSoft PC 
  70. Paintbrush Bitmap" files, and 2) the filter file "filters\IRPCX9.FLT" is the 
  71. filter DLL to load when trying to read these files.
  72.  
  73. For readability, the entries in the default KUDO.INI also include the file 
  74. extension at the beginning of the <description> field, but this is cosmetic - 
  75. only the <extension> field is actually used to determine the file extension.
  76.  
  77. The same filter DLL can be specified in more than one entry.  This way it is 
  78. possible to alias several file extensions as the same file type.  For example, 
  79. the Micrographix Drawing File Format is listed twice in the default KUDO.INI 
  80. file, for both the .DRW and .GRF file extensions.  However, you can only
  81. have one entry for each file extension.  For example, you cannot have two
  82. lines specifying .PCX as the file extension.
  83.  
  84. By convention, the filter DLL's that are shipped with kudo bear the file 
  85. extension .FLT, but they can have any file extension.  It is recommended that 
  86. abide by this convention and use a .FLT or .DLL extension.
  87.  
  88. New file types can be added to Kudo simply by modifying KUDO.INI.  Any DLL 
  89. that implements the Aldus Graphic Import Mechanism, either Interface Version 
  90. 1.0 or 2.0, can be listed as an import filter in the [KudoImageBrowserImports] 
  91. section.  This interface is documented in the Aldus "Filter Developer's 
  92. Toolkit", published by Aldus Corporation. For questions about the Aldus 
  93. standard, you can contact them at:
  94.  
  95.         Aldus Developers Desk
  96.         Aldus Corporation
  97.         411 First Avenue South
  98.         Seattle, WA  98104-2871
  99.         206/628-6593
  100.  
  101.  
  102.  
  103. ******************************************************************************
  104. [KudoPlacePacks]
  105. ----------------
  106. This section lists each of the available place modules. These Place Modules 
  107. are provided to enable Kudo to Drag and Drop with pinpoint accuracy onto 
  108. applications that fall into one or more of the following three categories: 
  109. 1) applications that are not registered as OLE 2.0 drop targets in the 
  110. [OLEDropTargets] section (see below), 2) applications that do not accept an 
  111. image file drop from the File Manager, or 3) applications that require special 
  112. handling for a drop.
  113.  
  114. Kudo uses an application's window caption to identify it, and consequently, 
  115. match it with the appropriate place module, if it exists. The [KudoPlacePacks] 
  116. section  of KUDO.INI tells Kudo 1) which applications have place modules, and 2) 
  117. which place modules to load in order to drag and drop to that application.
  118.  
  119. The syntax of one of these entries is:
  120.  
  121.         <application name>=<path>,
  122.  
  123. where
  124.         <description>:  The application caption as it appears on the title bar
  125.         <path>:         Path (full or relative) to the .DLL file that functions 
  126.                         as place module for this application. This is a regular 
  127.                         DOS pathname.  If it is not a fully qualified path, it 
  128.                         is interpreted as relative to the directory where the 
  129.                         currently executing copy of KUDO.EXE was found.
  130.  
  131.  
  132. As in the [KudoImageBrowserImports] section described above, there should be 
  133. no spaces around the equal sign ('=') or comma (','). The ending comma is 
  134. required even if there is no accompanying comment.
  135.  
  136.  
  137. ******************************************************************************
  138. [OLEDropTargets]
  139. ----------------
  140. This section identifies applications which have implemented an OLE 2.0 drop 
  141. target interface and have been tested as drop targets with Kudo. 
  142.  
  143. Kudo uses an application's window caption to identify it, and consequently, 
  144. match it with the appropriate data transfer object module. The [OLEDropTargets] 
  145. section  of KUDO.INI tells Kudo 1) which applications are OLE 2.0 drop targets, 
  146. and 2) which data transfer object to load in order to drag and drop to that 
  147. application.
  148.  
  149. The syntax of one of these entries is:
  150.  
  151.         <application name>=<path>,
  152.  
  153. where
  154.         <description>:  The application caption as it appears on the title bar
  155.         <path>:         Path (full or relative) to the .DLL file that functions 
  156.                         as the data transfer object module for this application. 
  157.             This is a regular DOS pathname. If it is not a fully 
  158.                         qualified path, it is interpreted as relative to the 
  159.                         directory where the currently executing copy of KUDO.EXE 
  160.                         was found. By default, this data transfer object is 
  161.                         mdataxfr.dll.
  162.  
  163.  
  164. As in the [KudoImageBrowserImports] section described above, there should be 
  165. no spaces around the equal sign ('=') or comma (','). The ending comma is 
  166. required even if there is no accompanying comment.
  167.  
  168.  
  169.  
  170.